home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / graphic / pbmpl91d.zip / PBMPLUS / MAN / PPMTOACA.MAN < prev    next >
Text File  |  1993-01-08  |  6KB  |  139 lines
  1.  
  2.  
  3. ppmtoacad(1)               Unix Programmer's Manual               ppmtoacad(1)
  4.  
  5.  
  6. NAME
  7.      ppmtoacad - convert portable pixmap to AutoCAD database or slide
  8.  
  9. SYNOPSIS
  10.                ppmtoacad [-dxb] [-poly] [-background colour] [-white] [-aspect
  11.                                                      ------
  12.                ratio] [-8] [ppmfile]
  13.                -----        -------
  14.  
  15. DESCRIPTION
  16.      Reads a portable pixmap as input.  Produces an AutoCAD(R) slide  file  or
  17.      binary  database  import  (.dxb)  file  as  output.   If  no  ppmfile  is
  18.                                                                    -------
  19.      specified, input is read from standard input.
  20.  
  21. OPTIONS
  22.  
  23.      -dxb An AutoCAD binary database import (.dxb) file is written.  This file
  24.           is read with the DXBIN command and, once loaded, becomes part of the
  25.           AutoCAD geometrical database and can be viewed and edited  like  any
  26.           other  object.  Each sequence of identical pixels becomes a separate
  27.           object in the database;  this  can  result  in  very  large  AutoCAD
  28.           drawing files.  However, if you want to trace over a bitmap, it lets
  29.           you zoom and pan around the bitmap as you wish.
  30.  
  31.      -poly
  32.           If the -dxb option is not specified, the output of ppmtoacad  is  an
  33.           AutoCAD  slide  file.  Normally each row of pixels is represented by
  34.           an AutoCAD line entity.   If  -poly  is  selected,  the  pixels  are
  35.           rendered  as  filled  polygons.  If the slide is viewed on a display
  36.           with higher resolution than the source pixmap, this will  cause  the
  37.           pixels  to expand instead of appearing as discrete lines against the
  38.           screen background colour.  Regrettably, this  representation  yields
  39.           slide files which occupy more disc space and take longer to display.
  40.  
  41.      -background colour
  42.                  ------
  43.           Most AutoCAD display drivers can be configured to use any  available
  44.           colour  as  the screen background.  Some users perfer a black screen
  45.           background, others  white,  while  splinter  groups  advocate  burnt
  46.           ocher,  tawny  puce,  and  shocking  grey.   Discarding pixels whose
  47.           closest AutoCAD colour representation is  equal  to  the  background
  48.           colour  can substantially reduce the size of the AutoCAD database or
  49.           slide file needed to represent a bitmap.  If no  -background  colour
  50.           is  specified,  the screen background colour is assumed to be black.
  51.           Any AutoCAD colour number may be specified as the screen background;
  52.           colour  numbers  are  assumed  to  specify  the  hues defined in the
  53.           standard AutoCAD 256 colour palette.
  54.  
  55.      -white
  56.           Since many AutoCAD users choose  a  white  screen  background,  this
  57.           option  is  provided as a short-cut.  Specifying -white is identical
  58.           in effect to -background 7.
  59.  
  60.      -aspect ratio
  61.              -----
  62.           If the source pixmap had non-square pixels, the ratio of  the  pixel
  63.           width  to  pixel height should be specified as ratio.  The resulting
  64.                                                          -----
  65.           slide or .dxb file will be corrected so that pixels on  the  AutoCAD
  66.           screen  will be square.  For example, to correct an image made for a
  67.           320x200 VGA/MCGA screen, specify -aspect 0.8333.
  68.  
  69.  
  70.                                10 October 1991                               1
  71.  
  72.  
  73.  
  74. ppmtoacad(1)               Unix Programmer's Manual               ppmtoacad(1)
  75.  
  76.  
  77.      -8   Restricts the colours in the output file to the 8 RGB shades.
  78.  
  79.      All flags can be abbreviated to their shortest unique prefix.
  80.  
  81. BUGS
  82.      AutoCAD has a fixed palette of 256 colours, distributed  along  the  hue,
  83.      lightness,  and  saturation  axes.   Pixmaps  which  contain many nearly-
  84.      identical colours, or  colours  not  closely  approximated  by  AutoCAD's
  85.      palette, may be poorly rendered.
  86.  
  87.      ppmtoacad works best if the system displaying  its  output  supports  the
  88.      full  256  colour  AutoCAD  palette.  Monochrome, 8 colour, and 16 colour
  89.      configurations will produce less than optimal results.
  90.  
  91.      When creating a .dxb  file  or  a  slide  file  with  the  -poly  option,
  92.      ppmtoacad finds both vertical and horizontal runs of identical pixels and
  93.      consolidates them into rectangular regions to  reduce  the  size  of  the
  94.      output  file.   This is effective for images with large areas of constant
  95.      colour but it's no substitute for true raster to vector  conversion.   In
  96.      particular, thin diagonal lines are not optimised at all by this process.
  97.  
  98.      Output files can be huge.
  99.  
  100. SEE ALSO
  101.      AutoCAD  Reference  Manual:   Slide  File  Format  and   Binary   Drawing
  102.                                    -----  ----  ------        ------   -------
  103.      Interchange (DXB) Files, ppm(5)
  104.      -----------  ---  -----
  105.  
  106. AUTHOR
  107.           John Walker
  108.           Autodesk SA
  109.           Avenue des Champs-Montants 14b
  110.           CH-2074 MARIN
  111.           Suisse/Schweiz/Svizzera/Svizra/Switzerland
  112.      Usenet:  kelvin@Autodesk.com
  113.      Fax:     038/33 88 15
  114.      Voice:   038/33 76 33
  115.  
  116.      Permission to use, copy, modify, and distribute  this  software  and  its
  117.      documentation  for any purpose and without fee is hereby granted, without
  118.      any conditions or restrictions.  This  software  is  provided  ``as  is''
  119.      without express or implied warranty.
  120.  
  121.      AutoCAD and Autodesk are registered trademarks of Autodesk, Inc.
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.                                10 October 1991                               2
  138.  
  139.